home *** CD-ROM | disk | FTP | other *** search
/ CD ROM Paradise Collection 4 / CD ROM Paradise Collection 4 1995 Nov.iso / dskutil / diskl310.zip / DISKLASR.DOC < prev    next >
Text File  |  1993-12-03  |  15KB  |  414 lines
  1.  
  2.  
  3.  
  4.                         DISKLIST LASER COMMAND GUIDE
  5.                           Revised December 3, 1993
  6.  
  7.      This is a guide to help you use DISKLIST on a HP LaserJet.  Since
  8.      other brand laser printers emulate the HP PCL (Printer Control
  9.      Language) this information is applicable to most laser printers.
  10.      The purpose is to help you customize the laser commands that
  11.      DISKLIST sends to the printer.  This will give you control over
  12.      how and where DISKLIST is printed.
  13.  
  14.      The basic syntax of a PCL command is:
  15.  
  16.           The first character is ESC
  17.  
  18.           ESC is followed by printable ASCII characters - letters,
  19.           numbers and symbols.
  20.  
  21.           The last character is always an uppercase letter.
  22.  
  23.      The simplest command is to reset the printer - ESC E.
  24.  
  25.      There is a space after ESC in this documentation for clarity.  In
  26.      the actual HP laser command there is no space.  In the DISKLIST
  27.      laser command editor, the ESC is displayed as a left arrow with
  28.      no space.
  29.  
  30.      ESC is usually followed by two characters that identify a family.
  31.      The first is usually a symbol and the second a lowercase letter.
  32.  
  33.      These are followed by a number.  It can be an integer or a
  34.      decimal to 4 decimal places, depending on the command.
  35.  
  36.      Example:
  37.  
  38.           To set the point size to 12, the command is:   ESC (s12V
  39.  
  40.           To set the pitch to 10 characters per inch:    ESC (s10H
  41.  
  42.  
  43.      Note that the integers match the desired value of the parameter,
  44.      and the point command ends in V for vertical and the pitch
  45.      command ends in H for horizontal.  Both commands have the family
  46.      characters (s.
  47.  
  48.      One final rule.  Commands that have the same two characters after
  49.      ESC can be grouped together without repeating the ESC or the
  50.      common 2 characters.  In this case, the last letter of each
  51.      imbedded command must be lowercase.
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.                                       -1- 
  60.  
  61.  
  62.  
  63.      Example:
  64.  
  65.           Using the commands of the previous example to form one
  66.           command produces:
  67.  
  68.                            ESC (s12v10H
  69.  
  70.           Note the v is now lowercase.
  71.  
  72.      Warning:  Case is very important.  Also, do not confuse the
  73.      number 0 and the letter O, or the number 1 and the lower case L.
  74.      If you are not getting the results that you expect, look at your
  75.      commands very carefully for these substitutions.
  76.  
  77.  
  78.      LASER COMMAND SETUP
  79.  
  80.      DISKLIST has a set of laser commands for each format.  They are
  81.      in the file DISKLIST.LSR.  It also has a laser command editor,
  82.      accessed with F6, so you can easily change them.  Remember to
  83.      save the changes you make in this file with F9.  The laser
  84.      commands are setup in the following categories:
  85.  
  86.                              Symbol
  87.                              Spacing
  88.                              Pitch & Point Size
  89.                              Orientation
  90.                              Top Margin
  91.                              Lines per inch
  92.                              Left Margin, Row
  93.  
  94.                              Reset
  95.  
  96.      You can put any commands on any line.  These categories are for
  97.      reference only.  Although the order is important because the
  98.      value of one command effects the operation of other commands.
  99.      This will be discussed later with left margin and row.
  100.  
  101.      When laser printer is selected, DISKLIST concatenates all of the
  102.      commands in the first 7 categories and sends them to the printer.
  103.      After the list is printed, DISKLIST sends the commands in the
  104.      eighth category, Reset.
  105.  
  106.      You don't have to have any laser commands.  Many of these
  107.      parameters are inherent in the default font or can be set by
  108.      controls on the printer.  You may need a few commands, such as
  109.      top and left margin, and lines per inch.  The editor has a key
  110.      to delete the commands on one line, F7, or all commands for a
  111.      format, F8.
  112.  
  113.      Laser commands are all printable ASCII characters except ESC.
  114.      The IBM character set displays ESC as a left pointing arrow.  So
  115.      does DISKLIST.  To enter ESC on the command line, just press the
  116.  
  117.  
  118.                                       -2- 
  119.  
  120.  
  121.  
  122.      ESC key.  Since the ESC key is used for input, press Function
  123.      Key 10 to exit the editor.  I try to make my software consistent,
  124.      so DISKLIST will quit all functions when F10 is pressed.
  125.  
  126.  
  127.      SYMBOL
  128.  
  129.      Within a font set are many symbol sets.  The IBM lines that
  130.      DISKLIST uses to print the frames are in the symbol set called
  131.      IBM-PC(USA).  The command to use this symbol set is ESC (10U.
  132.  
  133.      Some fonts do not have this symbol set, so the printer will
  134.      select another set close to it, but that symbol set probably
  135.      won't have the IBM lines.  In that case you can use the ASCII
  136.      lines or select a label format that doesn't have lines.
  137.  
  138.  
  139.      SPACING
  140.  
  141.      This command sets the character spacing to proportional or fixed.
  142.      Since DISKLIST prints columns and a frame, the fixed spacing must
  143.      be selected.  The command for fixed spacing is ESC (s0P.  For
  144.      proportional spacing the command is ESC (s1P.
  145.  
  146.      Most fonts only come in one type of spacing, proportional or
  147.      fixed so this command is probably ignored.  And, you don't
  148.      want to use a proportional font with DISKLIST.
  149.  
  150.  
  151.      PITCH AND POINT SIZE
  152.  
  153.      These commands were used in the example above.  DISKLIST uses two
  154.      sets, one for normal and one for compressed.  They are:
  155.  
  156.           Normal         ESC (s10.00h12.0V
  157.  
  158.           Compressed     ESC (s16.66h8.5V
  159.  
  160.  
  161.      ORIENTATION
  162.  
  163.      This command determines whether the list will be printed in the
  164.      Portrait or Landscape mode.  The commands are:
  165.  
  166.           Portrait     ESC &l0O
  167.  
  168.           Landscape    ESC &l1O
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.                                       -3- 
  178.  
  179.  
  180.  
  181.      TOP MARGIN
  182.  
  183.      This command positions the list from the top of the page.
  184.      Remember, with most lasers there is a border around the page
  185.      where the printer cannot physically print.  If you set it up to
  186.      print there, nothing will be printed in this area.  The command
  187.      for the number of lines down from the top is ESC &l#E where #
  188.      represents the number of lines.
  189.  
  190.  
  191.      LINES PER INCH
  192.  
  193.      Lines per inch control the vertical spacing of the data lines.
  194.      There are two ways to select this.  Either select a specific
  195.      number of lines per inch, or select a fractional vertical motion
  196.      index.
  197.  
  198.      The lines per inch command is ESC &l#D where # is the number of
  199.      lines per inch.  However, unlike most of the other commands, this
  200.      command only allows specific numbers.  They are 1, 2, 3, 4, 6, 8,
  201.      12, 16, 24, and 48.
  202.  
  203.      Line spacing by vertical motion index command is ESC &l#C.
  204.      # represents the number of 1/48 inch increments and can be a
  205.      decimal.  The following table illustrates some useful values but
  206.      any value is acceptable by PCL.
  207.  
  208.  
  209.                                Lines
  210.                                 per
  211.                                Inch          #
  212.  
  213.                                 6.0         8.00
  214.                                 6.5         7.38
  215.                                 7.0         6.86
  216.                                 7.5         6.40
  217.                                 8.0         6.00
  218.                                 8.5         5.65
  219.                                 9.0         5.33
  220.                                 9.5         5.05
  221.                                10.0         4.80
  222.                                10.5         4.57
  223.                                11.0         4.36
  224.                                11.5         4.17
  225.                                12.0         4.00
  226.  
  227.  
  228.      LEFT MARGIN
  229.  
  230.      This command positions the list from the left edge of the
  231.      page.  Before version 3.0, DISKLIST used the command ESC &a#L
  232.      for the column number to start printing in, where # represents
  233.      the column number.  This is important when you position the
  234.  
  235.  
  236.                                       -4- 
  237.  
  238.  
  239.  
  240.      list on labels.  The positioning of the left margin is based
  241.      on the current horizontal motion index which was set by the
  242.      pitch command.
  243.  
  244.      DISKLIST now uses ESC &l0U to set the left margin because it
  245.      is required for the shade feature.  This is the PCL5 command
  246.      for Left (Long Edge) Offset Registration.
  247.  
  248.      If your laser printer does not have PCL5 compatibility, then
  249.      you may change the left margin commands to ESC &a#L in all the
  250.      formats you expect to use.  You may edit the file DISKLIST.LSR
  251.      with the DOS EDIT and use Search and Change, or you may use
  252.      the DISKLIST.LSR file from an earlier version of DISKLIST.
  253.      This change will only work with the Output Devices Laser
  254.      Printer and Ink Jet Printer.  The laser commands for all the
  255.      other laser output device selectios are imbedded in DISKLIST.
  256.      SHADE will still work after this change if you set the left
  257.      margin to 0.
  258.  
  259.  
  260.      ROW
  261.  
  262.      Row positions the start of the list down from the top margin,
  263.      not the top of the page.  The command is ESC &a#R where # is the
  264.      number of lines below the top margin.  Since it is in the &a
  265.      family, DISKLIST puts this in one command with the left margin.
  266.      The positioning of the row based on the current vertical motion
  267.      index which was set by the lines per inch command.
  268.  
  269.  
  270.      DEFAULT COMMANDS
  271.  
  272.      F6 will insert these commands in the editor for the selected
  273.      format only:
  274.  
  275.                      Pitch ==>   Normal             Compressed
  276.  
  277.           Symbol              ESC E ESC (10U        ESC E ESC (10U
  278.           Spacing             ESC (s0P              ESC (s0P
  279.           Pitch & Point Size  ESC (s10.00h12.0V     ESC (s16.66h8.5V
  280.           Orientation         ESC &l0O              ESC &l0O
  281.           Top Margin          ESC &l0E              ESC &l0E
  282.           Lines per inch      ESC &l6D              ESC &l8D
  283.           Left Margin, Row    ESC &l0U ESC &a1R     ESC &l0U ESC &a1R
  284.  
  285.           Reset               ESC E                 ESC E
  286.  
  287.      The symbol command is preceded by the ESC E, the reset command.
  288.      This forces a page eject in some printers, so you may want to
  289.      eliminate it.  If laser printer is selected, CTRL E will also
  290.      send a page eject from the control window.  If you want to print
  291.      more than one list on a sheet, remove the reset, then use CTRL E
  292.      to eject the page.
  293.  
  294.  
  295.                                       -5- 
  296.  
  297.  
  298.  
  299.      DOWNLOAD FONT
  300.  
  301.      DISKLIST sends the following commands to the laser when it
  302.      downloads your font that you have selected from the Download
  303.      Window.
  304.  
  305.                     Reset                    ESC E
  306.                     Font ID Assignment       ESC *c#D
  307.                     The Font File
  308.                     Font ID Assignment       ESC *c#D
  309.                     Make Font Permanent      ESC *c5F
  310.                     Select Font              ESC (#X
  311.  
  312.      # is the font number.  DISKLIST generates a number by adding 70
  313.      to the sequence number of the font in the font selection window.
  314.      Except selection 10, which is assigned the number 70.  So the
  315.      range of font ID numbers that DISKLIST assigns is from 70 to 79.
  316.      You can then reselect a font with the command ESC (#X.  The
  317.      downloaded fonts are lost when the printer is turned off.
  318.  
  319.  
  320.      MORE
  321.  
  322.      This is just a beginning of learning about PCL.  It is sufficient
  323.      to produce useful lists and labels.  There are many more commands
  324.      that may be of help in configuring DISKLIST to print lists
  325.      exactly as you like.  They are all in your printer manual.  I
  326.      hope this write-up helps you to read and understand the laser
  327.      printer manual.
  328.  
  329.  
  330.      HELPFUL HINTS
  331.  
  332.      If you download or select a font, delete all laser commands
  333.      (use F8 in the editor), then insert a command for lines per
  334.      inch and commands for top, left margin, and row.  Otherwise
  335.      the commands will override the selected font and the printer
  336.      will select another.
  337.  
  338.      If the vertical IBM lines look like dashes, squeeze the lines
  339.      together by printing more lines per inch.  Use the ESC &l#C
  340.      command.
  341.  
  342.      With a laser printer you can create your own list formats.  For
  343.      example, if you have a 6 point 25 pitch font, you can use the
  344.      format for 5.25 inch 5 across to print a list that can hold 165
  345.      file names and be cut to fit the size of a 3.5 inch disk.  Then
  346.      tape the list to the back of the diskette with one small piece of
  347.      tape placed along the edge of the diskette that doesn't go into
  348.      the drive.  You then have a list that stays attached to the
  349.      diskette even when it is inserted in the drive.
  350.  
  351.  
  352.  
  353.  
  354.                                       -6- 
  355.  
  356.  
  357.  
  358.      DISKLIST LASER COMMAND REFERENCE CARD
  359.  
  360.  
  361.  
  362.                     Reset                   ESC E
  363.  
  364.                     Point Size              ESC (s#V
  365.                     Pitch                   ESC (s#H
  366.  
  367.                     Portrait                ESC &l0O
  368.                     Landscape               ESC &l1O
  369.  
  370.                     Top Margin              ESC &l#E
  371.                     Left Margin             ESC &l0U  (PCL5)
  372.                     Left Margin             ESC &a#L  (Before PCL5)
  373.  
  374.                     Row                     ESC &a#R
  375.  
  376.                     Lines Per Inch          ESC &l#D
  377.  
  378.            Valid Values of # for lines per inch are:
  379.  
  380.                 1, 2, 3, 4, 6, 8, 12, 16, 24, and 48.
  381.  
  382.                     Vertical Motion Index   ESC &l#C
  383.  
  384.            # represents the number of 1/48 inch increments and can be
  385.            a decimal.  The following table illustrates useful values:
  386.  
  387.                                Lines
  388.                                 per
  389.                                Inch          #
  390.  
  391.                                 6.0         8.00
  392.                                 6.5         7.38
  393.                                 7.0         6.86
  394.                                 7.5         6.40
  395.                                 8.0         6.00
  396.                                 8.5         5.65
  397.                                 9.0         5.33
  398.                                 9.5         5.05
  399.                                10.0         4.80
  400.                                10.5         4.57
  401.                                11.0         4.36
  402.                                11.5         4.17
  403.                                12.0         4.00
  404.  
  405.  
  406.  
  407.  
  408.  
  409.  
  410.  
  411.  
  412.  
  413.                                       -7- 
  414.